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SOFTWARE? 





WE’LL DO THAT OURSELVES! 


Three examples explained 


Karel Walraven and David Daamen 


Elsewhere in this issue is an article for a stepper motor driver. 
This article describes the demonstration software for this circuit. 
We explain how these programs came about and find that 
there are several ways of achieving our goal. 


We have purposely kept the software for the stepper motor 
driver as simple as possible. This makes it easier to follow 
and allows you to use it as a basis for your own software. 
Examples are given in assembler as well as C. These two 
examples are meant for use with the 89S8252 Flash Micro- 
controller Board (Elektor Electronics, December 2001). The 
third example is in Visual Basic and works on a PC. This lets 
you generate the required signals without the use of special 
hardware. 


Assembler 


We’ll first cast our eye over the assembler program, which is 
the file that ends in .asm. The designer of the stepper motor 
driver has developed the program using Proview32, which 
also includes an assembler. 


The program (Listing 1) first specifies which inputs and out- 
puts are used. The pushbuttons connect to pins P1.6 and P1.7, 
and pins P3.4 and P3.5 output the square waves. If you 
choose different pin names, the microprocessor will use these 
as inputs and outputs. 

First we test Button_17. If this button isn’t pressed, the input 
is at logic High and the program jumps to label ‘ccw’. The 
code then tests Button_16 and if this isn’t pressed either the 
program jumps back to label ‘cw’. As long as no button is 
pressed, the processor follows this loop indefinitely. 

When a button is pressed the input at P1.6 or P1.7 is con- 
nected to ground and the program doesn’t jump, but executes 
the following instructions. The following actions now take 
place: L_1 goes high, delay, L_2 goes high, delay, L_1 goes 
low, delay, L_2 goes low, delay. The routine has therefore 
gone through a complete cycle of a square wave. The pro- 
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Listing 1. Assembler program 


; Stepper motor software for use with the 89S8252 flash board 


; Horst Hubert 


; Two switches are used to control the motor. One between 

; P1.7 and GND (Button_17 for turning clockwise) and one between 

; P1.6 and GND (Button_16 for turning counter clockwise). 

; Turning cw/ccw is an assumption: the actual direction is of course 
; dependent on how the motor is connected. 

; In the cw direction, the motor will turn at higher speed than in 


; ccw direction. 


; Declarations 





; = 
Button_17 equ P1.7 
Button _16 equ P1.6 


if equ P3.4 
Ti A equ PORS 
org 0000h 


; Turning cw 





r 


cw: jbButton_17,ccw 


; 
cwl: setb I Al ;coil 1 high 
call ZSE 
setb TE ;coil 2 high 

call zsr 
clr a il ;coil 1 low 
call zsr 
clr ih 2 ;coil 2 low 
call zsr 
sjmp cw 


; Turning ccw 





r 


ccw: jb Button_16,cw 


gram then tests if the button is still pressed and repeats the 
previous actions. 

The delay routine consists of two nested loops. The inner loop 
decrements register RO from 255 to 0, and this happens 20 
times (the value in R1). By varying this value, you can gener- 
ate square waves of a different frequency, causing the motor 
to run at a different speed. 

This is just about the simplest driver program that can be 
written. 


C 


The C program (Listing 2, the name of the file ends in .c) is 
more compact than the assembler listing. This also starts with 
some declarations. The first line includes a complete file con- 
taining a set of standard declarations for our processor. This 
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r 


ccwl: setb Ta A ;coil 1 high 
call zsl 
clr L2 ;coil 2 low 
call zsl 
clr Lil ;coil 1 low 
call zsl 
setb L2 ;coil 2 high 
call zsl 


sjmp ccw 


; Delay for turning cw 
; 


ZSr: mov R0, #255 
mov R1, #20 
zsrl: djnz RO,zsrl1 
djnz R1,zsr1 


ret 


Delay for turning ccw 


zsl: mov R0, #255 
mov R1,#255 
zsll: djnz RO,zsl11 
djnz R1,zsl1 
ret 
end 


type of file always ends in .h. Many manufacturers make 
these files available for use with their processors. 

Next, we have to define the inputs and outputs, just as in the 
assembler program. Sbit tells the C compiler that L_1 is one 
bit in size and is connected to a single processor pin, with an 
internal microprocessor address of B4. We won’t go into fur- 
ther detail here, but more information can be found in the 
datasheet for the 89S8252 in the section ‘special function reg- 
isters’. Later on in the program use is made of the variables i, 
j and k. The compiler needs to know about these in advance, 
since it has to reserve memory space (2 bytes for an integer) 
and also use the right type of maths routines, in this case rou- 
tines for integers (abbreviated to int). 

In this program the delay routine is implemented as an inde- 
pendent sub-routine (a function), which also has to be 
declared in advance. The size of the delay is given as an inte- 
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Figure 1. This 
macro for MS Word 
generates signals on 

the printer port. 
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Listing 2. C program 


/*Stepper motor software for use with the 89S8252 flash board 


Horst Hubert 


Two switches are used to control the motor. 


One between 


P1.7 and GND (Button_17 for turning clockwise) and one between 
P1.6 and GND (Button_16 for turning counter clockwise). 
Turning cw/ccw is an assumption: the actual direction is of course 


dependent on how the motor is connected. 


The values of j and k determine the speed of the motor. 


one of the two buttons is pressed. 


The motor only runs when 


This source code is intended for use with FSI’s ProView32 compiler 


E 
#include <reg51.h> 


sbit at 0xB4 L 1; 
sbit at 0xB5 L 2; 
sbit at 0x96 Button _ 16; 
sbit at 0x97 Button_17; 


int i; 
sme IS 
int k; 


void delay(int); //Function declaration 


void main() 
{ 
while(1) 
{ 
while(!Button_17) 
{ 


//infinite loop 
//turning cw 
j=4000; 

iy i Slp 

delay(j); 


iy A Silg 
delay(j); 


Elektor - Square wave gener. x| 


| 100000 Set speed | 
Stop | 
Left | 


Right | 








iby tl cy 

delay(j); 

ib 2 SOF 

delay(j); 
} 


while(!Button_16) 
{ 


//turning ccw 
k=200; 


iy tl Sale 
delay(k); 
ib 2 SOF 
delay(k); 
ih il Sg 
delay(k); 
I 2 Shp 
delay(k); 


} 


void delay(int m) 
{ 
for(i=0; 


icm AAH)? 


} 


ger after the name of the function, which is why we have int 
in brackets after the name of the routine. The delay routine 
doesn’t return a value to the calling program. For this reason 
the word void is in front of the routine. You will have noticed 
that with higher level languages there are more declarations. 
This has the effect of shortening the program code. Every- 
thing is declared at the start, so you don’t have to worry about 
these things in the actual program. 


And now for the main program. In C this is always called 
main. It is through this convention that the compiler knows 
where the program starts. Since it is the main program it 
doesn’t take any arguments, nor does it return a result. For 
this reason there are empty brackets after main and it has 
void in front of it. This main program starts with a loop 
(while(1)) that runs indefinitely. This statement really means: 
do the following while ‘1’ is equal to a logical one. Since the 
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Listing 3. Visual Basic program: the most important parts 


‘Elektor Example Square Wave Generator for use with Stepper Motor Driver 
“030203-II May 2004 


4 


‘This examples employs inpout32.dll. Copy this DLL to /windows/system32. 
‘See http://www. logix4u.net/ 








Public Declare Sub Out Lib “inpout32.d11” _ Out (Port), 0 ‘reset printer port 
Alias “Out32" (ByVal PortAddress As Integer, While Run 
X While Cw 
ByVal Value As Integer) ‘use external Out 888, 1 ‘turn clockwise: make 
library for direct LPT access ‘output 1 high first 
Public Delay As Long Sleep Delay ‘pause for one half 
Public Run As Boolean ‘period 
Public Ccw As Boolean Out 888, 3 ‘switch on the second 
Public Cw As Boolean ‘output too (90 degrees!) 
Sleep Delay 
Sub Sleep(Delay As Long) ‘count the value in Out 888, 2 ‘switch off first output 
Delay and do nothing Sleep Delay 
ThisDelay = Delay Out 888, 0 ‘switch off second output 
While ThisDelay > 0 ‘too 
ThisDelay = ThisDelay - 1 Sleep Delay 
DoEvents ‘pass control to the OS to DoEvents ‘pass control to the OS 
‘prevent hanging ‘to prevent hanging 
Wend Wend 
End Sub 
While Ccw 
Sub Square Wave Generator() ‘hide the main Out 888, 3 ‘reverse: both outputs 
Word window and show the macro form ‘high 
‘show Word again after exiting Sleep Delay 
Out 888, 1 ‘switch off second output 
Documents (“Square wave_gen.doc”) .Windows(1).Vi Sleep Delay 
sible = False Out 888, 0 “switch off first output 
form. Show ‘too 
Sleep Delay 
Documents (“Square _wave_gen.doc”) .Windows(1).Vi Out 888, 2 ‘switch output 2 on again 
sible = True Sleep Delay 
End Sub DoEvents 
Wend 
Sub Output(Port As Integer) ‘generate some DoEvents 
square waves Wend 
a Microsott Visual Basic Square wave aen [Square Wave Gen (Code) OOO 9} i 
|A$ ee Edt wiew Insert Format Debug Run Tools Add-ins window Help 218) x) 
| e-G 2 GRA EFE : 
Es 









aaa | 


FE Normal 
=) 88 Project (Square_wave_gen) 


| Elektor Example Square Wave Generator for use with Stepper Motor Driver 
*030203-II May 2004 












O S Microsott Word Objects ‘This example employs inpouts2.dli. Copy this DLL to /windows/systemG2 . 
B) This Dormen ‘See http://uww. loqaxdu.net/ 

1-28 Forms 
E rom Public Declare Sub Out Lib "inpout32ż.dli" _ 

5-6 Modues Alias "Out32” (DyVal PortAddress As Integer, 


v4? Square_Wave_Gen 


ByVal Value &s Integer) ‘use external library for direct LPT access 
S- References 


Public Delay As Long 
Public Run as Boolean 
Public Cew As Boolean 
Public Cw As Doolean 


Sub Slecp(Delay As Long) ‘count the valuc in Delay and do nothing 
ThisDelay = Delay 
While Thiobelay > U 
Thisdelay = ThisDelay - 1 
Dokvents ‘pass control to the OS to prevent hanging 
Vend 


E «| | nil 
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Figure 2. Macro 
opened in Visual 
BASIC Editor. 
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Figure 3. 

How to connect the 
stepper mofor 
control to your PC. 
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op stappenmotorprint 
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‘T’ is never changed, this is always true and the loop will go 
on forever. 

We now come to another loop. This time there is a condi- 
tion to be met: while Button 17 is not equal to a logic one. 
The exclamation mark indicates the condition is negated; it 
is compared to a not logic one. When the condition is satis- 
fied (the button is pressed and a ‘0’ is at the input), the pro- 
gram will execute all statements within the following curly 
brackets. 

The routine within the curly brackets creates a square wave, 
just like the assembler program. First, j takes the value 4000. 
Then output L_1 is set to ‘1’ and the delay routine now cre- 
ates a delay dependent on the value in j. This continues until a 
full square wave has been created. 

The part of the program following this routine has the same 
function, but this time the other button is tested. 

The final routine is the delay function. Since C programmers 
don’t like typing (and seem to prefer to write compact, 
obscure code) it’s written as a single-line function. As you 
may have guessed, this is a for-next loop, which begins at 
zero (i=0) and is incremented by one (i++) as long as the 
value is less than m (i<m). This m has a value that was given 
as a parameter when the function was called and in this case 
is either 4000 or 200. 


Visual Basic and the PC 


Our final example uses the printer port of a PC. This makes it 
possible to experiment with stepper motors if you don’t have 
a Flash Micro Board. This example is also very convenient in 
use, since you are unlikely to need any special programming 
software: we make use of the Visual Basic environment that is 
nowadays integrated with Microsoft Office. The only extra 
software that needs to be installed is a little helper program 
that permits direct access to the parallel port. Windows NT 
and XP no longer let normal programs access this port. You 
therefore have to copy the file inpout32.dll to the folder \win- 
dows\system32. This helper program works transparently 
with some other versions of Windows (98SE and ME): the 
port will still be driven correctly. Unfortunately, this software 


won’t work with older versions of Windows. 

The actual Visual Basic program is in fact a macro for 
Microsoft Word. The most important parts are shown in 
Listing 3. 

Here too we have declarations, a delay function, a function 
that pops up the macro window (Figure 1) and temporarily 
hides Word, and finally a function that toggles the output pins 
in the correct order, just as in the other examples. 

There is some other code as well, but there is not enough 
space to go into details here. The document including the 
macro can be downloaded from the Elektor Electronics web- 
site (030203-11). Remember to turn off macro security before 
opening the document. Go to Tools/Macro/Security. Choose 
one of the lower two options, so don’t use ‘high’. If you now 
open the document and permit the use of macros, the program 
window will appear automatically. When you close this win- 
dow, Word will re-appear again. 


You can now open the Visual Basic Editor using alt-F11 (Fig- 
ure 2). To the right will be a small window showing ‘Project 
(Square_wave_gen)’. Below this project are a few folders 
with a document (the document containing the macro), the 
code and description of the form to control the software, a 
module with the actual program and possible references to 
other files. If you inspect the code belonging to the form it 
should soon become clear how the macro operates. 


Operation 


All software can be downloaded from the Elektor-Electronics 

website. We assume that owners of Flash Micro Boards don’t 

need to be told how to load a program into their boards. But if 
you do need more information, it can be found in the Decem- 

ber 2001 issue of Elektor Electronics. 


The Visual Basic software is hidden inside a Word file and is 
automatically started as soon as the document is opened. Its 
operation is very straightforward. A number can be entered in 
a text box (defaults to 10000). This value determines the fre- 
quency of the signals on the printer port. The effect of this 
value depends on the speed of the PC’s processor. If other 
programs are running at the same time, they too will influence 
the output signal. You will have to find the best value for your 
PC by trial and error. 


Finally, Figure 3 shows the pinout of the sub-D connector, 
which connects the stepper motor driver to the printer port. 
Connect pin 2 and 3 of the printer port to P3.4 and P3.5 of the 
stepper motor board. 

(030203-2) 


All software for this project can be downloaded 
under number 030203-11 at 


www.elektor-electronics.co.uk/dl/dl.htm, 
select month of publication. 
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